This makes sense. However, could we rename prefix to group? It would better align with the underlying method we use.

This makes sense. However, could we rename prefix to group? It would better align with the underlying method we use.

done

Please rebase your branch onto upstream/develop. If you don't have an upstream remote configured, add it first and then run:

git rebase upstream/develop

It looks like your branch was updated by merging/adding commits from develop, so this PR now includes unrelated commits:

• 4f28d51 chore: fix code styles (chore: fix code styles #1324)
• 22bf063 chore: fix phpstan (chore: fix phpstan #1325)
• a1384fa chore: remove deprecated rector class (chore: remove deprecated rector class #1326)

Those should not be part of this PR. Please rebase your branch on top of the latest develop instead, and sign your commits while rewriting them.

If you do not already have the main Shield repository added as upstream, add it first:

git remote add upstream https://github.com/codeigniter4/shield.git
git fetch upstream

Then rebase your branch:

git checkout feat/prefix-options-to-routes

# optional safety backup
git branch backup/feat-prefix-options-to-routes

git rebase -i --rebase-merges --exec "git commit --amend --no-edit -S" upstream/develop

In the interactive rebase, drop the unrelated commits listed above if they appear. Keep only the commits that belong to this PR.

Then force-push the cleaned branch:

git push --force-with-lease origin feat/prefix-options-to-routes

Please use rebase rather than merging develop into the PR branch, so the PR only contains your changes.

@dimtrovich Thanks for the PR!

Previously, we encouraged users to handle this via standard route groups like so:

$routes->group('accounts', static function($routes) {
    service('auth')->routes($routes);
});

However, this new group option is a great shorthand.

Could you please add a quick reminder to the docs regarding filters? Something like:

Note: If you have grouped or changed the default route format, ensure your paths match the new format in the app/Config/Filters.php file.